…ll/retrieveById, add prime() (Locks #11 reversed + #12/#13)

Per Commander 2026-05-13 Architecture Lock revisions:

- Lock #11 REVERSED: retrieveById no longer passthrough — removed from public surface.
- NEW Lock #12: retrieveAll removed from public surface. Response middleware is the sole steady-state trigger of inner.retrieveAll.
- NEW Lock #13: prime() is the only consumer-facing fetch entry point — idempotent, in-flight-deduped against middleware-driven retrieveAlls, no-op once a successful inner retrieve has completed in this session and localHash !== null.

Implementation:

- The `retrieveAll` closure is replaced by a private `triggerInnerRetrieveAll` coordinator that owns the in-flight ref, the skip-when-equal check, the persist-after-success snapshot, and a new `hasCompletedAtLeastOnce` flag.
- The response middleware's per-cacheKey handler now does TWO things on every observed hash: (a) bump currentServerHash, (b) fire-and-forget `triggerInnerRetrieveAll()`. The trigger inherits in-flight dedup + skip-when-equal, so an equal observed hash is short-circuited internally; an async rejection on the inner promise is contained inside the inflight closure's try/finally and a top-level `.catch(() => {})` ensures no unhandled rejection escapes back to abort the caller's request.
- `prime()` short-circuits when `hasCompletedAtLeastOnce && localHash.value !== null`; otherwise delegates to `triggerInnerRetrieveAll()` and awaits its resolution, surfacing failures to the caller.
- The returned module is exactly `{getAll, getById, getOrFailById, generateNew, prime}` — no `retrieveAll`, no `retrieveById`.

Type narrowing:

- New exported type `CachedStoreModuleForAdapter<T, E, N>` in src/types.ts captures the narrower surface. The factory's return type changes from `StoreModuleForAdapter<T, E, N>` to `CachedStoreModuleForAdapter<T, E, N>`. The new type is intentionally NOT assignable to `StoreModuleForAdapter<T, E, N>` (no `retrieveAll`/`retrieveById` properties) — verified by a `@ts-expect-error` assertion in the type test.
- Re-exported from src/index.ts as a named type export.

See orders/fs-packages/fs-cached-adapter-store-public-surface-narrowing-engineer-deployment.md for the full specification.

…ll/retrieveById, add prime() (Locks #11 reversed + #12/#13)

Per Commander 2026-05-13 Architecture Lock revisions:

- Lock #11 REVERSED: retrieveById no longer passthrough — removed from public surface.
- NEW Lock #12: retrieveAll removed from public surface. Response middleware is the sole steady-state trigger of inner.retrieveAll.
- NEW Lock #13: prime() is the only consumer-facing fetch entry point — idempotent, in-flight-deduped against middleware-driven retrieveAlls, no-op once a successful inner retrieve has completed in this session and localHash !== null.

Implementation:

- The `retrieveAll` closure is replaced by a private `triggerInnerRetrieveAll` coordinator that owns the in-flight ref, the skip-when-equal check, the persist-after-success snapshot, and a new `hasCompletedAtLeastOnce` flag.
- The response middleware's per-cacheKey handler now does TWO things on every observed hash: (a) bump currentServerHash, (b) fire-and-forget `triggerInnerRetrieveAll()`. The trigger inherits in-flight dedup + skip-when-equal, so an equal observed hash is short-circuited internally; an async rejection on the inner promise is contained inside the inflight closure's try/finally and a top-level `.catch(() => {})` ensures no unhandled rejection escapes back to abort the caller's request.
- `prime()` short-circuits when `hasCompletedAtLeastOnce && localHash.value !== null`; otherwise delegates to `triggerInnerRetrieveAll()` and awaits its resolution, surfacing failures to the caller.
- The returned module is exactly `{getAll, getById, getOrFailById, generateNew, prime}` — no `retrieveAll`, no `retrieveById`.

Type narrowing:

- New exported type `CachedStoreModuleForAdapter<T, E, N>` in src/types.ts captures the narrower surface. The factory's return type changes from `StoreModuleForAdapter<T, E, N>` to `CachedStoreModuleForAdapter<T, E, N>`. The new type is intentionally NOT assignable to `StoreModuleForAdapter<T, E, N>` (no `retrieveAll`/`retrieveById` properties) — verified by a `@ts-expect-error` assertion in the type test.
- Re-exported from src/index.ts as a named type export.

See orders/fs-packages/fs-cached-adapter-store-public-surface-narrowing-engineer-deployment.md for the full specification.